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1.0 SCOPE 


1.1 IDENTIFICATION 


The Software Requirements Specification (SRS) establishes the requirements for the Computer 

Software Configuration Item (CSCI) identified as the Globally Relocatable Navy Tide/Atmosohere 
Modeling System (PCTides). ^ 


1.2 System Overview 


The Computer Software Configuration Item (CSCI), identified as the Globally Relocatable Navy 
Tide/Atmosphere Modeling System (PCTides) consists of a 2- and 3-dimensional barotropic 
tide/surge model, called the Global Environmental Modeling Services (GEMS) Coastal Ocean 
Model (GCOM2D and GCOM3D), and a Mesoscale Atmospheric Prediction System (MAPS). 

GCOM2D is a depth-integrated shallow water model designed to characterize sea level and currents 
on or near continental shelves. It features a wetting and draining algorithm for simulating coastal 
flooding due to tides or storm surge. 

GCOM3D is the three-dimensional counterpart to GCOM2D. It is a barotropic model for 
applications where current structure with vertical depth is required and tidal and wind forcing are 
dommant. Atmospheric forcing for GCOM2D/3D is provided by an e.xisting operational Navy 

model, by the MAPS system, by an analytical hurricane vortex model, or by direct point 
observation. 

MAPS is a hydrostatic primitive equations model designed to provide high-resolution 
representations of anemometer level winds and surface pressure as atmospheric boundary 
conditions for GCOM2D and GCOM3D. To this end, the turbulence closure scheme has been 
designed to allow the model to be run with its lowest model level at anemometer height thus 
providing a direct simulation of the winds at this level. The equations of motion are coded in 
advective form and solved using a semi-implicit time differencing scheme ensuring that the model 
is both robust and economical to run, even in regions of steep terrain. 


1.3 Document Overview 

The purpose of this document is to specify the functional requirements for the tide/surge portion 
of PCTides, GCOM2D/3D. It describes the input to the system, processing flow, output of the 
system, and the objective analysis. This document has been written to the software 
documentation standards for environmental system product development. Each facet of the 
model, including I/O and algorithms, are described in general terms, avoiding explanations of the 
coding used to implement these quantities. Coding is explained in detail in the PCTides 
Software Design Description. This document is divided into the followinc sections; 


Mjniiscn(M .ippiovoil lvhmai\' 2.^. 2001. 
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Section I 

Section 2 
Section 3 
Section 4 
Section 5 

Section 6 
Appendix A 


Identifies the CSCI system, providing 
within this document. 


an overview of the system requirements 


Provides a list of all documents referenced within the program. 

Specifies the CSCI requirements that are conditions for acceptance by the system. 

States the methods used to ensure that each requirement has been met. 

Provides the ability to trace each CSCI requirement in this specification to the 
system requirements it addresses. 

Provides applicable notes including a glossary of acronyms. 

Provides a Software Requirements Specification for the MAPS atmospheric 
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3.0 REQUIREMENTS 

This section discusses the PCTides capabilities, interface, adaptation, and resource requirements. 
PCTides has been written to be user friendly and platform independent by which the model can 
be executed through a graphical user interface or a DOS mode or UNDC command line prompt. 
All PCTides configuration managed routines and subroutines are written in FORTRAN 90. 

3.1 CSCI Capability Requirements 

The GCOM2D portion of the PCTides model is a hydrodynamic model used to model depth- 
integrated currents and sea surface height on or near continental shelves and can be adapted to 
simulate coastal flooding due to tides and storm surge. GCOM3D is a barotropic z-coordinate 
model used to characterize current structure with vertical depth when tidal and wind forcing 
dominate. The MAPS portion of the model contributes an atmospheric forcing element to the 
model. It provides hi^ resolution spatial representation of the wind and pressure fields for 
GCOM2D/3D. 

There are five main capabilities in the GCOM2D/3D model that will perform the following 
functions; 

Set up grid, bathymetry and boundaiy conditions. 

Derive surface winds and atmospheric pressures (if desired). 

Set parameters for controlling the type of forcing and model output 
Select and run GCOM2D or 3D model using the same setup data. 

Select output display options. 


Within each of these capabilities are several subfunctions that serve to input information into the 
model and to produce a variety of output files for the specified analysis region which are 
described in the following subsections. For each subfunction, a description of inputs and outputs are 
provided for both PC Windows menu and command prompt use. Figure 3.1-1 illustrates the 
interactions between the functions and subfunctions within the PC Windows interactive menu. 
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Main Menu 



Sub Menus 


GENERATTEtaub 


get BATHYMETRY 


gethdes 


MAPS WINDS 


NOG^WB^ 


MANUAL WBybs 


hurricane 


PARAMETERS 


STAitONS 


GCOM3D 


CURRENTS 


HEIGHTS 


SPEED TS 


DIRECTS 


TIDAL BC 


2D BATHYMETRY 


3D BATHYMETRY 


ASAGRID.EXE 

GCOMGRID.EXE 


-► TIDES.EXE 

-► DA2SEQ.EXE 

7 ' ► NRL2SEQJXE 

forecast! 

TRACK | -> WINDS.EXE 
-►CYCLONE.EXE 

lg^[ -»CYCLQNE.EXE 

-► GCOM.DAT 

-► STATIONS.DAT 


GCOM2D.EXE 


GCOM3D.EXE 


OMDISP.EXE 


ZPLOT.EXE 


SPDPLOT.EXE 


DBRPLOT-EXE 


PLOTTOE-EXE 


BATHPL0T.EXE 


PLOT3D.EXE 



Figure 3.1-1: Chart illustrating the PC Windows Menu and related files. 
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3.1.1 Set Up Grid, Bathymetry and Boundary Conditions 

3.1.1.1 Define the model domain 


Command Prompt 
Input: 

Input values for parameters such as area title, grid projection flag, latitude and longitude limits, and 
standard grid spacing to create “gridgemdat” in the ‘^gems\work” directoiy. It is structured as' 
follows: 


Line 

Parameter 

Typical value 

1 

Arbitrary Title 

Persian Gulf 

2 

Grid Projection Flag (do not change) 

3 

3 

Southern Latitude Limit 

22.0000 

4 

Northern Latitude Limit 

31.0000 

5 

Western Longitude Limit 

^ 46.0000 

6 

Eastern Longitude Limit 

60.0000 

7 

Standard Grid Spacing (kms) 

10.0 


Output: 

File “gridgen.dat”. 


Menu 

Input: 

The Generate Grid” menu option initiates the ASA grid projeetion program. A unique output file 
name must be speeified for identification and storage. 

Output: 

An ASCII file is written to the “\gems\gridgen\depths” directory with the user specified file 
name and an .asc extension. This file contains the latitude and longitude limits of the region 
selected. 

3.1.1.2 Generate the bathymetry on defined grid 

Bathymetiy and topography are extracted for each grid point for the selected model region. The 
latitude and longitude of the grid point are determined and all direct access topography files are 
searched to find the value at that location from the highest resolution “.da” file containing that 
point. 
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Command Promnf 


Input: 

The program “gridgen” that reads the latitude and 
gndgen.dat” file generates the bathymetric grid from 


longitude limits resolution stored in the 
the global direct access files. 


Output: 

‘Gndgen” wntes the data to the file “topog.dat” in the “\gems\work” directory. 


Menu 


Input: 

Mmts St ft?'™ fire^T™ ' “O^sgrid” reads 

global direct access files bathymetric grid from 


Output: 

Writes bathymetric data to the file ‘topog.dat” in the \gems\work” director’. 
3* 1.1^3 Get tidal boundary conditions 




m2.dat 

s2.dat 

n2.dat 

k2.dat 

2n2.dat 

ol.dat 

kl.dat 

q 1 .dat 


Command Prompt: 

Input: 

Run “tides”. 

Output: 

Creates gridded file of tidal boundary conditions. 
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Menu: 


Input: 

“Get Tides” is selected for deriving tidal boundary conditions. 

Output: 

Creates gridded file of tidal boundary conditions. 


3.1.2 Derive Surface Winds and Atmospheric Pressure (if desired) 

Before the model is run, the winds to force the ocean model may be obtained from three possible 
sources: 1) NOGAPS or some available higher resolution winds (COAMPS/DAMPS), 2) entered 
manually, or 3) developed using the hurricane model. 

For more information refer to Appendix A . 


3.1.2.1. Derive NOGAPS or some higher resolution winds 


NOGAPS or some higher resolution wind (i.e., COAMPS/DAMPS) files are used to derive 
surface winds and atmospheric pressures to force the ocean model. 

Command Prompt 
Input: 

MAPS winds may be derived by running “da2seq”. NOGAPS or some higher resolution winds 
may be derived by running “nrl2seq”. 

Output: 

The atmospheric file, which contains surface winds and pressure, is interpolated to the model 
grid using “topog.dat” and written to the binary sequential file “atmos.dat”. 

Menu 


Input: 

Model winds may be derived by selecting “MAPS Winds” or “NOGAPS Winds” from the 
menu. 

Output: 

The atmospheric file, which contains surface winds and pressure, is interpolated to the model 
grid using “topog.dat” and written to the binary sequential file “atmos.dat”. 
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3.1.2.2 Enter winds manually 

there is no accounting for spatial variation of the winds. ^ ^ regions as 

Command prompt 

Input: 

Output: 

a fil' ^ written to 

nis proauces a wind file that is time vaiying but spatially constant. 

Menu 


Input: 

in “manual winds" pane, of 

Output: 

the “atmos^dat” fill^ TW^p^rod^es a wLd fik tlS “topog.dat” file and are written to 

nis proauces a wind file that is time varying but spatially constant. 

3,1*2,3 Derive hurricane winds 

t uS'which°faki*^ ‘™k 'pZiSr«I ^ynnnyntous in this documentation) 
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3.1.2,4 Forecast track 

The forecast track is defined in the “cyclone.dat” file. The menu offers a more interactive 
method of establishing the track than can be accomplished at the command prompt; therefore 
they are described separately. The structure of this file is as follows (with sample values 
included): 


Line 

Parameter 

T3T3ical Value 

1 

Environmental pressure (hPa) 

1005 

2 

Holland “b” parameter (see SDD 
5.2.4.3) 

1.75 

3 

Dummy integer parameter 

0 

4 

Output time step (hours) 

0.5 

5 

Dummy real parameter 

ioo 

6 

Plot flags (wind, MSLP,dummy) 

0 0 0 

7 

Time zone 

8.0 

8 

Date, Time, Latitude, Longitude, 
Pressure, Radius of Maximum Winds 

19990322 0400 -20.80 114.50 915.0 33.0 

9 

repeat line 8 for each time step 



Command prompt 


Input: 

The “cyclone.dat” file is edited to set up the track data. 

Output: 

Updated track information is stored in “cyclone.dat”. 

Menu 


Input: 

The track is defined by entering the required parameters concerning the initial state of the 
hurricane (latitude, longitude, central pressure, speed, radius of maximum winds, date and time) 
and then specifying its expected coastal crossing point or destination. 

Output: 

Updated track information is stored in “cyclone.dat”. 

3.1.2.5 Hindcast Track 

Historical tracks can be hindcast from stored track files by recovering the historical track file 
from “\gems\tctracks” where it is stored with a “.trk” extension. Copying the format of existing 

files and allocating an appropriate name (less than 9 characters) can create new historical track 
files. 
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Command orompf 
Input: 

p “\gems\tctracks” to “cycIone.dat” in the “\gems\work” directory 

Edit the cycIone.dat” file to adjust the start time if required. 

Output: 

Updated track information is stored in “cycIone.dat”. 

Menu 

Input: 

m«rl •'“'/“I*®* hurricane track file. Adjust the start time if simulation of the 

Output: 

Updated track information is stored in “cycIone.dat”. 

S. 1.2.6 Hurricane Model 

After a forecast or hindcast track file is established, the hurricane model generates wind and 
pressure fields on the model grid by referring to the “topog.dat” file. 

Command promnt 
Input: 

Run “cyclone”. 


Output: 


Snnainterpolated on the model grid 
topog.dat file and wntten to “atmos.dat”. uuci guu 


using 


Menu 

Input: 

Select “CYCLONE Model”. 


Output: 


“terpolared on the model grid 

topog.dat file and wntten to “atmos.dat” ^ 


using 
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3.1.3 Set Parameters for Controlling the Type of Forcing and Model Output 
3.1.3.1 Set GCOMparameters 

Prior to running the ocean model, parameters that control the type of forcing and model output 
must be established. 

Input: 

There are a few parameters that must be specified for the model run. These are stored in the file 
“gcom.dat” which has the following structure (sample values at end of line): 


Note: Refer to the User’s Manual for instructions on editing these parameters. 


Line 

Parameter 

Typical Value 

1 

wind flag (0=off, l=on) 

1 

2 

tide flag (0=off, l=on, 2=on + tidal data assimilation) 

1 

3 

nesting flag (0=off, l=on) 

0 

4 

screen flag (0=text, l=vectors) 

0 

5 

inundation flag (0=off, l=on) 

0 

6 

wave setup or datum adjustment (meters) 

0.0 

7 

output file time interval (hours, 0=none) 

1.0 

8 

tidal start time, time zone (hh,mm,dd,mm,vyvv,hours) 

00 00 23 06 1999 19.0 

9 

maximum model run time (hours) 

168 


Command prompt 
Input: 

Edit “gcom.dat”. 

Output: 

Updated “gcom.dat” file. 

Menu 


Input: 

Select “Parameters”. 

Set parameters in the input panel. 

Output: 

Updated “gcom.dat” file. 
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3A3,2 Define stations 

One of the features of the model is to produce time series output of sea levels and ocean currents 

at specified locations. Pnor to running the model, the location of these “stations” must be 
defined by setting up the “stations.dat” file. 

(one per line) defined as latitude, longitude and 
ame Jhe user is advised to have at least one output station defined for each model^n The 
format for the “stations.dat” file is as follows: ^ ^ 


Latitude 
(-90.0 to 90.0) 

Longitude 
(0 to 360 E) 

Station Name 
(max 8 characters) 

Model Output Level 
(1 for GCOM2D^ 

26.17000 

56.55000 

Pgulfl 


26.70000 

56.28000 

PgulfZ 

1 

24.00000 

58.00000 

Pgulf3 

T 

26.50000 

53.40000 

Pgulf4 

1 

25.67000 

52.40000 

PgulfS 

fl 

24.45000 

53.37000 

Pgulf6 

1 ~ 

27.00000 

49.72000 

PgulfZ 

1 

29,27000 

50.33000 

PgulfE 

1 ~ 

29.83000 

48.72000 

PgulfP 

1 


^e set of stations defined for a model region can be saved with 
directory and recalled for later model runs. 


a “.stn” extension in the “work” 


Command promp t 


Input: 

Copy a “.stn” file to “stations.dat” and/or edit “stations.dat”. 

Output; 

Updated station information is stored in “stations.dat”. 
Menu 


Input: 

Select “Stations”. 

Select a stored stations file. 

Edit the station data and save (exit). 

Output: 

Updated station information is stored in “stations.dat”. 
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3.1.4 Run GCOM2D Or 3D Model 

Either GCOM2D or GCOM3D may be run using the same set up data. The user would normally 
only use GCOM3D if near-surface currents were required. GCOM2D is faster and is used to 
predict sea levels as a result of tidal and/or hurricane forcing. GCOM2D can also simulate the 
inundation of coastal regions as a function of tidal ebb and flood or storm surge. 

Command prompt 

Input: 

Run “gcom2d” or “gcom3d”. 

Output: 

Once the model run begins, numerical data will appear on the screen. This data list displays the 
stations entered into the station file and the depths at that location associated with the model 
topography, the model time step and tidal time series time step, as well as the number of 
observational stations in the domain. 

Menu 


Input: 

Select “GCOM2D” or “GCOM3D”. 

Output: 

Once the model run begins, numerical data will appear on the screen. This data list displays the 
stations entered into the station file and the depths at that location associated with the model 
topography, the model time step and tidal time series time step, as well as the number of 
observational stations in the domain. 

3.1.5 Select an Output Display Option 

Various forms of display options are available for the PC user that may be run under the PC 
Windows Menu or at the DOS mode command prompt. The display code has been written for 
the PC format so there are no display options for running under UNIX. 

3,1.5.1 Ocean currents and sea levels 

Both GCOM2D and GCOM3D write output fields to the sequential binary file “gcom.out” at 
each model output time step. Currents and sea levels from this file may be displayed by running 
“omdisp” which offers an interactive menu to set display options. 

Command prompt 

Input: 

Run “omdisp” to set display options in the menu panel. 


LS 



PS I Technical Report SSC 004-00 


PCTides SRS 


Output: 

Plot of the horizontal fields of currents and sea levels. 


Menu 


Input: 

Select “Currents” to set display options in the menu panel. 

Output: 

Plot of the horizontal fields of currents and sea levels. 

3,1.5.2. Tidal height time series 


When the user specifies stations in the 
time series output at those stations and 
“.tsd”. 


menu or edits the “stations.dat” file, the model produces 
wntes to a file with the station name and an extension of 


Command prompt 


Input: 

Run “zplot” to specify the input file. 


Output: 

Time senes plot of model tidal height at a specified station. If data assimilation has been chosen 

the extension .thp . The .thp file types may also be plotted or overlayed on the station plots. 

Menu 


Input: 

Select “Height TS” to specify the input file. 

Output: 

Time senes plot of model tidal height at a specified station. If data assimilation has been chosen 

the ex^tensfon “ An” ^ 

• P . e .thp file types may also be plotted or overlayed on the station plots. 

J./.5. J Current speed and direction time 


series 


As descnbed earlier the time series of current speeds and directions 
may then be plotted. 

Command prompt 

Input: 

Run spdplot or “dirplot” and specify the input station. 


are written to “.tsd” files and 
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Output: 

Time series plot of current speeds and directions. 

Menu 


Input: 

Select “Speed TS” or “Direc TS” and specify the input station. 

Output: 

Time series plot of current speeds and directions. 

3.1.5.4 Tidal amplitudes and phases from the FES95.1/2.1 model 

Command prompt 

Input: 

Run “plotide” and specify the tidal constituent file (“m2.dat”, “ol.dat” etc. as defined in section 
3.1.1.3) and chose to include (or not) International Hydrographic Office (IHO) tidal station data 
in the output. 

Output: 

Plots of tidal amplitude and phase from the global tide model and, if chosen, IHO station 
amplitude and phase. 

Menu 


Input: 

Select “Tidal BC” and specify the tidal constituent file (m2.dat, ol.dat etc. as defined in section 
3.1.1.3) and chose to include (or not) IHO tidal station data in the output.. 

Output: 

Plots of tidal amplitude and phase from the global tide model and, if chosen, IHO station 
amplitude and phase. 

3.1.5.5 Three-Dimensional Bathymetry 

The program “plot3d” creates a three-dimensional surface mesh plot of the model bathymetry 
and topography. This program reads the “topog.dat” file and offers choices of viewing rotation 
angle (0-360° from due south) and viewing elevation angle (0-90°). 

Command prompt 

Input: 

Run “plot3d”. 
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Output: 

3-D surface mesh plot of PCTides bathymetry and topography. 
Menu 


Input: 

Select “3D Bathymetry”. 


Output: 

3-D surface mesh plot of PCTides bathymetry and topography. 
3.1.5.6 Two-Dimensional Bathymetry 


The pro^am Ijathplot generates a two-dimensional contour plot of the model hath\mi fn a 

bohomofLpIo? 

Command prompt 


Input: 

Rim “bathplot”. 


Output: 

2-D contour plot of the model bathymetry and color-coded topography. 

Menu 


Input: 

Select “2D Bathymetry”. 

Output: 

2-D contour plot of the model bathymetry and color-coded topography. 
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3.2 CSCI External Interfaces 

3.2.1 Interface IdentiHcation and Diagrams 

The only Navy standard PCTides external interfaces are the input and output files. 

The input files consist of the following types of data; 

1. archived topographic data. 

2. model domain parameters in ‘GRIDGEN.DAT’. 

3. Global Tide Model (FES95.1/2.1) data. 

4. wind data from NOGAPS or some higher resolution field (i.e., COAMPS/DAMPS), 
from manual data entry, or derived from the hurricane model. 

5. various parameter and station location data for GCOM2D/3D. 

The output files consist of the following types of data: 

1. output stations where time series predictions of sea levels and currents are stored, 
output consisting of sea level and current spatial fields for the entire grid at preset 
(parameter file) time steps. 

The interfacing and operational environment for PCTides, which demonstrates the relationship 
between the components of the system and associated files, is illustrated in Figure 3.2-1. 
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GCOM running environmmt 



Figure 3.2-1; Flow diagram for the GCOM system. 
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3.3 CSCI Internal Interface Requirements 

The CSCI will be run from either a PC Windows interactive menu or through a DOS mode or 

UNIX command prompt. Refer to Figure 3.1-1 for an illustration of the internal interfacine of 
PCTides. 


3.4 CSCI Internal Data Requirements 

In PCTides the MAPS and GCOM running environments contain several other modules and 
pro^ams that are necessary to complete the modeling system. These include programs for 
setting up model grids over specified geographic regions, extraction and conversion programs in 
a suitable format for MAPS and GCOM2D and display options for viewing model output (SDD- 
Hubbert et al., 2000). 

MAPS Internal Programs: 

1. Grid Generator-GRIDGEN 

2. Input Conversion Program-NOGAPS 

3. Field Generator-AMSUBGRD 

4. Preprocessor-AMPREPSL, AMPREPPL 

5. Display Modules-AMD ISP, TSPLOT 

GCOM Internal Programs: 

1. Grid Generator-GRIDGEN 

2. Input Conversion Program-DA2SEQ 

3. Atmospheric Model-MAPS 

4. Tidal Model-TIDES 

5. Hurricane Model-CYCLONE 

6. Display Module-OMDISP, TSPLOT 


3.5 Adaptation Requirements 

There are no special adaptation requirements. 

3.6 Security and Privacy Requirements 

There are no CSCI security or privacy requirements. 
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3.7 CSCI Environment Requirements 


The PCTides model can be operated on PC Windows/DOS or UNIX oneratine ru. 

program also could be easily ported to other UNIX-type operating systei^s such as^INUX^v 
developers familiar with those environments. 

3.8 Computer Resource Requirements 


The CSCI planned use of computer hardware 
Windows/DOS and UNIX systems. 


resources is about 360 MB for both PC 


3.9 Software Quality Factors 

PCTides has been proven to perform all required functions and has been thoroughly tested as 

Z r^^dl '"t and the Software Test Deseif^forDt To 

the modulanty of the program, problems can be easily corrected, and the program <L be adapted 

an^ng r^uirements or modified for use in a new environment. The CSCI is user-friendlv 
and can be utilized in a variety of applications. ^ 


3.10 Design and Implementation Constraints 

None. 


3.11 Training and Personnel-Related Requirements 




3.12 Other Requirements 

None. 


Precedence and Criticality of Requirements 

None. 
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4.0 QUALIFICATION PROVISIONS 

The table below lists the validation test matrix for the CSCI requirements outlined in this 
specification. 


Section/Module 

Identification 

Validation type/ Reference 

Analysis Area 

No. of tests 

3.1.1 

Haltiner and Williams, 1980 



3.1.4, 3.1.6 
MAPS 

Holland, G.J., (1980) 

Australia-Darwin, Port 
Hedland; 

3 tests 

3.1.7-3.1.10 

Hubbert, G.D. et al. (1991) 

Cowley Beach, Australia 

6 tests 

3.1.7-3.1.10 

GCOM2D/3D 

Hubbert, G.D. and Mclimes, 
K.L., (1999a) 

Australia-Port Hedland, 

Port Phillip 

2 tests 

3.1.7-3.1.10 

Hubbert, G.D. et al., (1990) 

Australia- Bass Strait 

1 test 

MAPS; 

GCOM3D 

Mellor, G.L. and Yamada, 

T. (1974, 1982) 



GCOM2D 

Miller, M.J., and Pearce, 

R.P., (1974) 



MAPS 

Smith, S.D., and Banke, 

E.G. (1975) 

Sable Island, Nova Scotia; 

1 test 

GCOM2D 

Shapiro, R., (1970) 



GCOM2D/3D 

Signell, R.P. and Butman, 
B.(1992) 

Boston Harbor, Mass. 

1 test 

3.1-3.13 

STD; Preller et al. (2000) 


8 tests 
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5.0 REQUIREMENTS TRACEABILITY 


The Software Test Description (STD) includes eight 
routines (SDD) and requirements (SRS). 


test runs that 


encompass all CSCI 


SRS paragraph numbers: 


SDD 

Paragraph 

numbers: 




I 

1 

I 

1 

I 

i 

5.1 


X 

X 



IHI 

IHl 

n 

B 









X 
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X 





X 










X 








■■ 

X 
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^M\ 
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6.0 NOTES 

6.1 Acronyms 


ASA 

Applied Sciences Assoeiates 

CSCI 

Computer Software Configuration Item 

CSC 

Computer Software Component 

FES 

Finite Element Solutions 

GCOM2D 

Coastal Ocean Model 2-D 

GCOM3D 

Coastal Ocean Model 3-D 

GEMS 

Global Environmental Modeling Systems 

GMT 

Generic Mapping Tool 

mo 

International Hydrographic Office 

MAPS 

Mesoscale Atmospheric Prediction System 

NOGAPS 

Navy Operational Global Atmospherie Prediction 
System 

NRL 

Naval Research Laboratory 

OAML 

Oceanographic and Atmospheric Master Library 

PC 

Personal Computer 

PSI 

Planning Systems, Incorporated 

SDD 

Software Design Description 

SRS 

Software Requirements Specification 

SSC 

Stennis Space Center 

STD 

Software Test Description 

UNIX 

Workstation Operating System 
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APPENDIX A 


SOFTWARE REQUIREMENTS SPECIFICATION 
FOR THE 

GLOBALLY RELOCATABLE NAVY TIDE/ATMOSPHERE 
MODELING SYSTEM (PCTides) 

MESOSCALE ATMOSPHERIC PREDICTION SYSTEM 

(MAPS) 
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l.OA SCOPE 


LI A Identification 


Softw^e Requirements Specification (SRS) establishes the requirements for the 
Computer Software Configuration Item (CSCI) identified as the Mesoscale Atmc^^nhJ^ 
Naw (MAPS). MAPS is a supplemental model to the Globally RelocataWe 

Navy Tide/Atmosphere Modeling System (PCTides). ^ ^ 


1.2A System Overview 


maps is a hydrostatic primitive equations model designed to orovide biai. r^c^i f 

SSrocS'Td OCoiS^ atmospheric boun'd“ 

been designed to atfthTl™ e 

height, thus providing a direct simulation of fte winds Ms 

motion are coded in advective fonn and solved usitlra slTtaphclt dmeS “ 

steertemr™* '“"“"bcal to nm. even in re^tns of 


1.3A Document Overview 


The SRS summarizes 


iu.rcJr .u - requirements of MAPS Each section 

b^a "=<I“tements for running the system by a PC Windows intLnvLlu or 

by a command prompt. Command prompt operation is exactly the same in the DO<! 
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2.0A REFERENCED DOCUMENTS 

Please refer to 2.0 Referenced Documents. 

3.0A REQUIREMENTS 


This section discusses the MAPS capabilities, interface, adaptation, and resource 
requirements. MAPS has been written to be user friendly and platform independent, by 
which the model can be executed through a graphical user interface or a DOS mode or 
UNDC command line prompt. All MAPS configuration managed routines and subroutines 
are written in FORTRAN 90. 

3.1 A CSCI Capability Requirements 


The MAPS portion of the model contributes an atmospheric forcing element to the model. 
It provides high resolution spatial representation of the wind and pressure fields for 
GCOM2D/3D. 

Within each of its several capabilities are subfiinctions that serve to input information 
into the model and to produce a variety of output files for the specified analysis region 
which are described in the following subsections. For each subfunction, a description of 
inputs and outputs are provided for both PC Windows menu and command prompt use. 
Figure 3.1-1A illustrates the interactions between the functions and subfunctions within 
the PC Windows interactive menu. 


28 



PSI Technical Report SSC 004-00 


PCTides SRS 



Figure 3.1-1 A: Flow diagram for the MAPS system. 
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3.1.1 A Set Up Grid and Topography 


3.1.1.1 A Define the model domain 
The first step is to define the model domain. 

Command prompt 
Input: 

To define the model domain at the command prompt, the file “gridgen.dat” in the 
“\gems\work” directory is edited. It is structured as follows: 


Line 

Parameter 

Typical value 

1 

Arbitrary Title 

Spain 

2 

Grid Projection Flag (do not change) 

3 

3 

Southern Latitude Limit 

28.0000 

4 

Northern Latitude Limit 

43.0000 

5 

Western Longitude Limit 

343.0000 

6 

Eastern Longitude Limit 

2.0000 

7 

Standard Grid Spacing (km) 

20.0 


Note: Longitudes are in the range 0 to 360E. Latitudes are in the range -90 to +90. 
Output: 

File “gridgen.dat”. 

Menu 


Input: 

The “Generate Grid” menu option is selected which initiates the Applied Sciences 
Associates (ASA) grid selection program. This software allows the user to zoom in and 
create a new region by selecting the area for the model grid on the map with the mouse. 

Output: 

On completion the ASA grid generator writes an ASCII file to the 
“\gems\gridgen\depths” directory with an extension “.asc”. This ASCII file contains the 
latitude and longitude limits of the region selected. 

3.1.1.2A Generate topography grid 

Command prompt 

The next task is to generate the topographic grid. 
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Input: 

Run grWgen . Gndgen reads the latitude and longitude limits from the file 
fib's. calculates the topography and bathymetry from the global direct access 


Output: 

Gndgen” wntes the data to the file “topog.dat” in the “\gems\work” directory. 
Menu 


Input; 

Select “Get Topography”. 


Output: 


in the 


3.1.2A Set parameters for controlling the type of forcing and model output 

atmospheric model the user must set several parameters which control 
the type of forcing and model output. winiroi 

3.1.2.1A Set MAPS parameters 


Tfiere are a few pyameters that must be specified for the model run. These are stored in 
the file maps.dat which has the following structure (sample values at end of line); 


Line 

Parameter 

1 ypical Value 

1 

Nesting Model Name 
(NOGAPS or MAPS) 

nogaps 

2 

NOGAPS Unix File Path 

/net/omaha/ export/posey/disk2/eraeme/ 

3 

Start 1 ime (hh,dd,mm,vvw) 

m J JJ. - 

00 23 06 1999 

4 

Maximum Run Time 
(Hours) 

24 -- 

5 

Number Of Sigma Levels 

ri6~ ^ ^- 

6 

Sigma Levels 

U.IUO 0.200 0.250 0.300 0.400 0.550 0.700 0.780 
0.850 0.900 0.950 0.975 0.990 0 995 0 Q08 0 hoo 

7 

Output File Time Interval 
(Hours, 0=None) 

6 

8 

Time Step Factor 
(0<-> 1) 

0.95 


a coafse i^d M AP^ . m.T ^ of MAPS. Wlien nesting inside 

a coarse ^d MAPS mn the model will look for the output file from the previous run so 

IS important to make sure the two runs (coarse and fine grids) are consecutive. 
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Note; Instructions for editing parameter data can be found in the PCTides User’s 
Manual. 

Before running MAPS it is necessary to obtain analysis and forcing fields in which the 
model will be nested. The NOGAPS fields are stored on a UNIX workstation and it is 
necessary to run the data extraction program on that UNIX box. If MAPS is to be run on 
a PC there must be a network connection to the UNIX box and the UNIX “root” directory 
of the “\gems\work” directory must be mounted as drive “h”. This section describes the 
methods for obtaining nesting fields and then preprocessing them into the form required 
by MAPS. 

3.1.2.2A Obtaining Nesting Fields 

If the user requires NOGAPS fields it is necessary to use the UNIX system because the 
NOGAPS output is stored under the UNIX system (path defined in “maps.dat”). 

Two files must be present in the working directory before extracting the nesting fields: 

a. “maps.dat” which sets the nesting model (MAPS or NOGAPS), the path of the 
NOGAPS files (if required) and the analysis time. 

b. “topog.dat” which defines the region required. 

Command prompt 


In nmning the system, all other steps regardless of method are exactly the same at the 
UNIX command prompts as at the DOS mode command prompt. In the case of 
extracting the nesting fields Ifom NOGAPS however the DOS method is more complex 
due to the need to communicate between the PC DOS software and the UNIX 
workstation, via ftp connection or mounted drive connection. 

Input: 

Run “nogaps”. 

Output: 

The output files are named “nogaps.OOO”, “nogaps.006”, “nogaps.012” etc. where the 
file extension denotes the forecast hour. 

Menu 


Input: 

Select “NOGAPS Fields”. 
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Output: 

output files are named “nogaps.OOO”, “nogaps.006” 
file extension denotes the forecast hour. 


“nogaps.012” etc. where the 


3.L2.3A Preprocessing the Nesting Fields 




Command prompt 


Input: 

Run “amsubgrd” and then 
nesting in MAPS). 


“ampreppl” (for nesting in NOGAPS) or “amprepsl” (for 


Output: 


Preprocessor writes output files to “amsubgrd.OOO”, 
etc. at each model specified time step. 


“amsubgrd.006”, 


“amsubgrd. 012 ”, 


Menu 


Input: 

Select “Preprocessor”. 


Output: 


Preprocessor writes output files to “amsubgrd.OOO”, 
etc. at each model specified time step. 

3.1.3A Run MAPS 


“amsubgrd.006”, 


“amsubgrd.012”. 


MAPS requires the following files present in the “\gems\work” directory before it is run 


Input: 


a. “maps.dat” 

b. “stations.dat” 

c. “amprep.OOO” 
run duration. 


and as many “amprep” files as are necessary to define the model 


Command nromnt 


Input: 

Run ”maps”. 
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Output: 

Various forms of display options are available for the PC user. The display code has 
been wTitten for the PC and so there are no display options when running under UNIX. 
The display options may be run under the PC Windows Menu or at the command prompt. 

Menu 


Input: 

Select “Run MAPS”. 

Output: 

Various forms of display options are available for the PC user. The display code has 
been v,Titten for the PC and so there are no display options when running under UNIX. 
The display options may be run under the PC Windows Menu or at the command prompt. 


3.1.4A Select an output display option 

MAPS writes output fields to the direct access binary files “maps.OOO”, “maps.006”, 
“maps.012” etc. at each model output time step (defined by the file extension). Single 
level (e.g. surface pressure) and multi-level (e.g. winds) fields from the model run may be 
displayed by running “amdisp” which offers an interactive menu to set display options. 
The “amdisp” menu appears in both the menu and the PC command prompt 
environments and each entry parameter is supported with an “FI” help function to 
explain the option. 

Command prompt 

Input: 

Run “amdisp” and set the options in the menu panel. 

Output: 

Plots of horizontal surface fields of winds at preselected output time steps. 

Menu 


Input: 

Select “Horizontal fields” and set the options in the menu panel. 

Output: 

Plots of horizontal surface fields of winds at preselected output time steps. 

3.1.4.1A Wind Speed and Direction Time Series 

When the user specifies stations in the menu or edits the “stations.dat” file the model 
produces time scries output at those locations and writes to a file with the station name 


34 



PSI Technical Report SSC 004-00 


PCTides SRS 


extension of “.tsd". Wind speeds and directions from the^ file types may then be 

Command prompt 
Input: 

Run Vspdplot” or “wdirplot” and specify the input station. 

Output; 

Plot of time series output of selected station. 

Menu 


Input; 

Select “Wind Speed TS" or “Wind Direc TS” and specify the input station. 
Output: 

Plot of time series output of selected station. 


3.L4.2A Three-dimensional Topography 

A three-dimmsional surface mesh plot of the model topography (and bathymetrv) mav be 
obtatned wtth the program “plot3d”. This program readfthe •‘topog.daf^lt »d „ffem 
chps of vewmg rotation angle (0-360 from due south) and vijjg elevation^^e 5! 


Command promnt 
Input: 

Run “plot3d”. 

Output; 

Three-dimensional surface mesh plot of topography. 

Menu 


Input: 

Select “3D Topography”. 

Output: 

Three-dimensional surface mesh plot of topography. 
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3.1.4.3A Two-dimensional Topography 

A two-dimensional contour plot of the model topography may be obtained with the 
program “toplot”. This program reads the “topog.dat” file and allows the user to set the 
minimum plotting contour (meters). 

Command prompt 

Input: 

Run “toplot”. 

Output: 

Two-dimensional topographic contour plots. 

Menu 


Input: 

Select “2D Topography”. 

Output: 

Two-dimensional topographic contour plots. 
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3.2A CSCI External Interfaces 


3.2,1A Interface Identification and Diagrams 

The only Navy standard MAPS external interfaces are the input and output files. 
3.3A CSCI Internal Interface Requirements 


The CSCI will be run from either 
mode or UNIX command prompt 
MAPS. 


a PC Windows interactive menu or through a DOS 
Figure 3.3-lA illustrates the internal interfacing of 
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Main Menu 
















Sub Menus 


CTaSERiTEC3UD 


GETTOPOGRAPHV 


PARAMETERS 


STATIONS 


NOGAPS 


PREPROCESSOR 


HORI2X)NTAL FIELDS 


WIND SPEED TS 


WIND DIRECTS 


2D TOPOGRAPHY 


3D TOPOGRAPHY 


ASACaUD.EXE 


MAPSGRID.EXE 


MAPS,DAT 


►STATIONS.DAT 


NOGAPS.EXE 

AMSUBORD^EXE 

AMPREPPL.EXE 

^ MAPS.EXE 
AMDISP.EXE 


W^PDPLOT.EXE 


\VDIRPLOT.EXE 


^TOPLOT.EXE 


-PLOT3D,EXE 
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3.4A CSCI Internal Data Requirements 


The MAPS running environment contains several other modules and programs that are 

moderdriH modeling system. These include prograiSs for setting un 

c f ki specified geographic regions, extraction and conversion programs in a 

eraL, 2000™^^ display options for viewing model output (SDD; Hubbert 


MAPS Internal Programs: 

1. Grid Generator-GRIDGEN 

2. Input Conversion Program-NOGAPS 

3. Field Generator-AMSUBGRD 

4. Preprocessor-AMPREPSL, AMPREPPL 

5. Display Modules-AMDISP, TSPLOT 


3.5A Adaptation Requirements 

There are no special adaptation requirements. 


3.6A Security and Privacy Requirements 

There are no CSCI security or privacy requirements. 


3.7A CSCI Environment Requirements 

The MAPS model can be operated on PC Windows/DOS or UNIX operating svstems 

^ ^ f UNIX-type operating^systems luch as 

LINUX by developers familiar with those environments. 

3.8A Computer Resource Requirements 


Refer to section 3.8. 


3.9a Software Quality Factors 

b!cn’’LToSv '« all required fbnctions and has 

been thoroughly tested, as evidenced in the Software Test Descrintion Due to tho 

adamdd"fo fproblems can be easily corrected, and the program can be 
adapted to changing requirements or modified for use in a new environment The CSCI 
user-fncndly and can be utilized in a variety of applications. 
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3.10A Design and Implementation Constraints 

None. 


3.11 A Training and Personnel-Related Requirements 

Personnel must be trained in the use of either UNIX or the PC Windows operating 
systems to properly enter data and evaluate the model results to assure high quality output 
from MAPS. The interactive menu offered in the PC Windows format of this program 
greatly simplifies manipulation of the CSCI input and output options. 


3.12A Other Requirements 

None. 


3.13A Precedence and Criticality of Requirements 

None. 


4.0A QUALIFICATIONS PROVISIONS 


See Qualifications Provisions section of PCTides Software Requirements Specification. 


5.0A REQUIREMENTS TRACEABILITY 

See Requirements Traceability section of PCTides Software Requirements Specification. 


40 



PSI Technical Report SSC 004-00 


PCTides SRS 


6.0A NOTES 

6.1 A Acronyms 


ASA 

CSCI 

CSC 

GCOM2D 

GCOM3D 

GEMS 

GMT 

MAPS 

NOGAPS 

NRL 

OAML 

PC 

PSI 

SDD 

SRS 

SSC 

STD 

UNIX 


Applied Sciences Associates 
Computer Software Configuration Item 
Computer Software Component 
Coastal Ocean Model 2-D 
Coastal Ocean Model 3-D 
Global Environmental Modeling Systems 
Generic Mapping Tool 
Mesoscale Atmospheric Prediction System 

Navy Operational Global Atmospheric Prediction 
System 

Naval Research Laboratory 

Oceanographic and Atmospheric Master Library 

Personal Computer 

Planning Systems, Incorporated 

Software Design Description 

Software Requirements Specification 

Stennis Space Center 

Software Test Description 

Workstation Operating System 
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